Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXPrJobInit

QuickDraw GX sends the GXPrJobInit message when an application that supports the Macintosh Printing Manager calls the PrJobInit function to set up the structure that is used for displaying the Print dialog box when the PrDlgMain function is called. You can override the GXPrJobInit message to customize the handling of the GXPrJobInit function. Your override of the GXPrJobInit message must match the following formal declaration:

OSErr MyPrJobInit (THPrint aTHPrint, TPPrDlg *aTPPrDlg);

aTHPrint

A handle to the print record for this printing operation.

aTPPrDlg

A pointer to the TPPrDlg record for the Print dialog box.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXPrJobInit message sets up default controls in the Print dialog box.You can override this message if you need to add any special handling to the processing of PrJobInit calls by your printer driver.

SPECIAL CONSIDERATIONS

You never send the GXPrJobInit message yourself.

You almost always forward the GXPrJobInit message so that the default implementation can perform its operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The PrJobInit function is described in Inside Macintosh: Imaging With QuickDraw.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help